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ABSTRACT 
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INTRODUCTION 

with the availability of inexpensive graphic terminals , a new dimen- 
sion opens up in the.* use of computers for interactive teachiny. 

The teacher has the ability to provide the student with endless and 
imaginative illustrations for computer conversations and he can 
invite the student to experiment graphically with the effects of 
changing parameters or equations or changing the framework of the 
experiment. 

Working with ARDS 100 and Tektronix 4002 and 4010 terminals, our 
dialog facilities have been extended with graphic commands which 
allow the author to use the terminal facilities in a simple manner. 
(The coding can easily be ifiodified to work for other graphic ter* 
minals.) This new manual* is concerned with the use of these added 
instructions. 



*There are three previous manuals in the series (Appendix II) . 
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CHAPTER 1 

INITIALIZING THE DIALOG 

The first command in a dialog is, as usual, 

SYSTEM DIALOG 

This must be followed by NAME (or START) , and then DEVICE (see below) . 
END DIALOG is, as before, ^he last command in the program. 

If the dialog is divided into sections assembled separately, the 
DEVICE command should appear only in the first segment to be executed. 



CHAPTER 2 

PROCEDURES FOR DETERMINING THE TERMINAL 

DEVICE allows the student to indicate which terminal is in use, and 
sets a flag internally. 

DEVICE ARDS ,TEK 

or 

DEVICE ARDS, TEK, 'TEK 4010 f 

asks the student which terminal he is using. If he responds with one 
of the arguments, the program proceeds; otherwise it tells him 
on which terminals the program can run, and gives him the option 
of stopping if he is on some other kind. *TEK 1 implies a 4002 
terminal . 

DEVICE must fellow START or NAME and roust precede any graphic command. 
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CHAPTER 3 

CONTROLLING THE SCREEN 



A, LI'. ALL 

ERASE will erase the screen. On the ARDS and -TEK 4010 (not Tek 
4002) # it will also reset the cursor# the current beam position# 
to the top left corner. 



will 



B . HOME 

HOME moves the cursor to the top left of the screen. 

C. SETPOINT 

SETPOINT moves the cursor to the indicated point on the screen. It 
is useful for resetting the cursor to the point where printing of 
dialog material is to be resumed# after plotting is finished. It 
can be called in several ways. The most basic# 



xs aj 



SETPOI ST 



(FS * 1 * # FS 1 3 . 7 2 ' ) 



will position the cursor one inch over and 3.72 inches up from the 
lower left-hand corner of the screen on either terminal. 




SETPOINT (FS'l’ ,FS*3.72') 

Fig. 1 
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If A is a symbolic reference to a floating short *1* (all numeric 
arguments* are floating short unless otherwise specified) , and B 
is a symbolic reference to 3.72, then 

SETPOINT (A,B) 

will have the same result. 

SETPOINT (FS , 1* ,B) 

is also valid* SETPOINT can be called with the terminal specified: 

SETPOINT (ARDS, (A,B) ) , (TEK, (B,A) ) 

will position the cursor at (1,3.72) on an ARDS, and (3.72,1) on a 
TEK. 

SETPOINT is independent of all scaling and windowing data, i.e., it 
sets absolute points. 

D * SCREEN 

.SCREEN is a comprehensive command, with the options ERASE, HOME, 
SETPOINT, each used as above. 

SCREEN ERASE , ( SETPO INT , ( A , B ) ) 

will erase the screen and position the cursor at the point whose 
coordinate^ (£n inches) cure given in A and B. 



*Cp Appendix I. 
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CHAPTER 4 
WINDOWING ‘ 

Windowing is the setting up ol a separate rectangular area on the 
screen in which plotting is to take place. It enables the author to 
display a plot on one part of the screen, while continuing the dialog 
on another, or to show several plots on the screen at the same time. 

A. WINDOW 

WINDOW defines the rectangular space in which a curve or set of curves 
is to be displayed. 




• WINDOW (A,B) , (C,D) ,BOX 
Fig. 2 

specifies a window with lower left corner displaced A, B inches and 
upper right corner displaced C, D inches, measured from the lower left 
corner of the screen. A, B, C, D are, as in the SETPOINT command, 
floating short numbers or variables whose values are floating short 
numbers. The window is not drawn unless BOX is specified. 
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B. BOX 

BOX draws the last window specified on the screen. It can be used as 
an option with WINDOW or as a separate command. 



A single window command may specify the window differently for each 
terminal, so that differences in screen shape can be taken into 
account: 



A WINDOW command releases any previous window or scaling information. 
More than one window (containing curves , axes , etc . ) can be shown on 
the screen at one time, but any CURVE, AXES, or SCALE command will 
refer to the most recently defined window (or to the full screen if 
no window is in effect. ) 



should be used when the author wants to return to plotting on the 
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BOX 



do the same thing 
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WINDOW 



(ARDS, (A,B) , (C, D) ) , (TEK, (A,C) , (K,S) ) [,BOX] 



B) , (C,D) ,BOX 



The command 



NOWINDOW 



eft corner displaced A, B inches and 



D inches, measured from the lower left 



full screen; it also releases any previous scaling information 
The default is NOWINDOW. 
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CHAPTER 5 
SCALING 

The programmer can either allow the set of data to determine its own 
scale by specifying the MAX option when he calls CURVE or AXES (see 
below), or he can se the SCALE command separately, or the SCALE 
option with the command CURVE or AXES. 

The scaling will take effect within whatever window, if any, is 
currently defined. If the fu^l screen is in effect its full width 
will be used for the horizontal range defined by the MIN-MAX informa- 
tion, and the full height for the specified vertical range. If 
WINDOW is in effect, the ful window space will be utilized. 

SCALE enables the author to choose the scale in his own coordinates, 
related to the values in use. It is useful for plotting a series of 
different curves, not all containing the maximum and minimum, on the 
same frame. A typical procedure call for a scale is 

SCALE (XMIN ,XMAX) , (YMIN , YMAX ) ( , (ZMIN , ZMAX) ] 

where the arguments are floating short numbers* or variables whose 
values are floating short numbers. (If they are variables, they 
must be defined before they are used in a graphic command.) 

For a three dimensional curve (projected into two dimensions) the 
third argument is included. 

Any following WINDOW or NOWINDOW command wipes out the scaling 
information as well as substituting a new window size, (or restoring 
the full screen use) A second SCALE command (or the use of the 
MAX option or the SCALE option with the command CURVE or AXES) replaces 
the old scaling information with the new, but does not affect the 
current WINDOW (or NOWINDOW) state. 
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CHAPTER 6 
PLOTTING * 

The dialog graphic labilities permit both curve plot tiny and point 
plotting. These facilities arc implemented with the CURVE and 
POINT procedures. 

A. CURVE 

CURVE plots arrays of data* in 2 or 3 (projected) dimensions (data 
storage must be defined by the programmer before the command is used) • 
The CURVE command has numerous options, permitting a variety of 
plotting modes. The basic procedure call has the form: 

CURVE (V1,V2,N) 

In this case VI and V2 are names of arrays containing at least N 
values. N is the number of values in the array to be used in plot- 
ting, a variable or an integer. Without altering the values in the 
arrays, they are scaled and windowed according to the data specified 
by the last SCALE and WINDOW (or NOWINDOW) commands, or the last AXES 
command. If there is no previous scaling information, the 'MAX • 
option (see below) is issued, and the points are connected with 
straight lines output to the terminal. 

If the option SCALE is used within the CURVE command, as in 

CURVE (X,Y,N) , (SCALE, (HMIN,HMAX) , (VMIN,VMAX)) 

the new scale information is stored, and N points of the X and Y 
arrays are plotted according to the window and scale data now defined. 

CURVE . (MAX, (X,Y,N) ) 



*It is often convenient to compute these arrays in FORTRAN sub- 
routines. The user is also referred to the section (Appendix I) 
on the procedures DEF ARRAY and STORARRAY . 
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1 STORARRAY. 



will find the maximum and minimum of the X and Y arrays and store this 
as the new scale data. Then the array points will be plotted with 
connecting lines in the currently defined window. 

To plot (in two dimensions) a three dimensional set of points, the 
call could be: 

CURVE (X1,X2,X3,K) 

where K is the number of points. The same options can be used as 
with plots for two variables. 

You may begin plotting at any position in the arrays by 
CURVE (<X,5) , (Y,12) ,30) 

will plot the figure described by the 30 pairs of coordinates, 
beginning with the fifth element of X and the twelfth element of Y. 

Any of the vector arguments to CURVE may be indirect addresses. 

The option CENTER operates like MAX , but in addition will cause the 
graph to appear with its (0,0) or (0,0,0) point in the center of the 
screen or window: 

CURVE (CENTER, (X,Y,N) ) 

Other options are possible: the curve can be dotted (instead of solid, 

which is the default) . This is called by 

CURVE (A , ANEW, 12 ) , DOT 

It is also possible to save the code generated by a CURVE command 
and then call for a reshowing of that curve: 

CURVE (X, Y, Z, 40) , (SAVE, XX) 
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stores the code, (both command and data characters) , for the plot in an 
array XX (storage provided by programmer) ; and the command 

CURVE (ACM 14, XX) 

draws it unchanged without having to recalculate. If a point specified 
by the arrays in CURVE should fall outside the window (or full screen, 
if no window has been specified) , a line will be drawn to the inter- 
section point with the boundary, and the CURVE will be discontinued. 

If the option REENTRY is specified with CURVE, the first following 
point which falls inside the window will be plotted, with a segment 
of the line to the preceding outside point and plotting will be resumed. 




CURVE (X,Y,120) , (REENTRY) 

Fig. 4 

B* POINT 

This command enables the author to plot discrete points rather than 
a continuous curve. It functions like CURVE, and all options used 
with CURVE are valid with POINT- (except DOTJ). 
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POINT (X , Y , N) 

will plot N points of the arrays X, Y, (Fig. 5) using previously 
defined SCALE factors. 




POINT (X,Y,N) 

Fig. 5 

POINT (X1,X2,X3,N3) 

will produce a two dimensional projection of the N3 points on the 
XI, X2, X3 curve. 

C. LINE . 

The command: 

LINE (XI, Yl) , (X2,Y2) 

will draw a line from point (XI, Yl) to point (X2,Y2) , where Xl, 
Yl, X2, Y2 are floating short numbers, and are> within the limits 
set by SCALE. For example, the program: 
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SCALE 



(FS’-l* ,FS f l' ) , (FS •— 1 * ,FS * 1 * ) 



AXES LIMITS 

LINE (FS ' . 5 f ,FS ' 0 ' ) , (FS ' - . 8 ' ,FS’l* ) 

would produce the graph: 
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CHAPTER 7 
DRAWING AXES 

You can specify axes for both two and three dimensional systems , label 
axes, and indicate numerical values to determine the scale. The 
positive part oi each axis is a solid line and the negative dotted. 
Axes are drawn in proper relation to the scaled plot on the full 
screen or the window, whichever is in affect. 

The basic call 

AXES 

will use whatever information is in store for WINDOW and SCALE, and 
draw horizontal and vertical axes through the 0,0 (or 0,0,0) point. 

If this point is not within the range represented in the plot, the 
axes will be drawn through the lower left corner of the window (or 
screen) • 



AXES (DIM, 3) 

will do the same for three dimensions. 

Various options can be used: 

Example One 

AXES (SCALE, (HMIN,HMAX) , (VMIN,VMAX) ) 

will store the new data as scale information and draw 

the axes accordingly. 

Example Two 

AXES (MAX, (X,Y,N) ) 

will find the H and V minimum, maximum values of the N 
points in the X and Y arrays, use these to compute and 
store scale data, and draw the axes. This can be 
extended to: 
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Example Three 

AXES (MAX, (X,Y,Z,K) ) 



Another u:i':ful lion for A/CIJ.'J i:» LAIlKUj . 



AXES (MAX, (X,Y,N) ), (LABELS, 'X' , 'Y' ) 



o 

ERIC 



would function as in Example Two above, but would also label the 
axes. The arguments for LABELS must be strings. It can also be used 
in three dimensions. 

LIMITS will print the maximum and minimum values for each axis at 
the axis end-points 



AXES (MAX, (A,B,50) ) , LIMITS 
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WINDOW 
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NOTICS 

Will suppress the drawing of tic marks on the axes. (Default * tics). 
TICS 

Used without arguments, 

* 

AXES (DIM, 3), TICS 
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Will draw five evenly spaced tic marks on the larger sections of 
each axis, and appropriately fewer on the shorter. Used with 
arguments. 



AXES (LABELS , 'X' , f Y f ) , (TICS,FS' .l r ,FS r 10 r ) 

will draw the two axes, labeled as indicated, and draw tic marks at 
intervals of .1 on the ’X'-axis and 10. on the t Y* axis, where .1 
and 10, are chosen relative to the data arrays being plotted, and 
will be windowed and scaled exactly as the data arrays. 

AXES (LABELS, f X f , f Y f , 'Z') , (TlCS,FS f .1* ,FS • 10 • ,FS 1 1 . 5 1 ) 

will do the same, in three dimensions. 

Example : 

AXES (CENTER, (XA,YA,N) ) , (LABELS, 'Xl* , 1 X2 • ) ,LIMITS, ; 

(TICS ,FS * 1 * , FS * . 2 1 ) 

might give (in the case of a sine function) : 




Fi'g. 7 
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CHAPTER 8 

The user can store and reshow curves. The graphic data is stored 
on a disk file. 

A. SAVEPLOT 
The save command 

SAVEPLOT * argument" 

will save on disk the last figure displayed , in a file in the 
account in which the program is being run. This file name is speci- 
fied in the argument to "SAVEFLOT" and may be a character string 
literal ("FILEl") or the name of a location containing a character 
string. The file name should be less than 16 characters. When 
saved it will be prefixed with the letters "PIC" to help identify 
these saved plot files in the user's account. 

Only the last figure displayed is saved, without axes. For plots 
using axes , the axes must be drawn previous to the curve. Scaling 
and windowing information are automatically saved with the plot. 

B. SHOWPLOT 

The command for restoring a plot is 
SHOWPLOT "argument” 

where argument is the same as for "SAVEPLOT." It is not necessary 
to specify the "PIC" prefix when restoring a saved plot. To restore 
the axes as they were drawn for a particular saved figure, you need 
only execute an "AXES" command after restoring the saved plot, 
before making any changes in the scaling or windowing. All "AXES" 
options are valid. 
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APPENDIX I 



A. Notes on Numbers 

1. Constants and Variables . A constant is a quantity whose 
value is explicitly stated, for example, 3.14159, or 5. A variable is 
a numerical quantity that is referenced by name rather than by its 
explicit appearance in a program statement. During the execution of 
the program, a variable may take on many values. A variable is 
identified and referenced by a label (if it is a real number or integer) , 
or by a counter name (if it is a counter) . 

2. Kinds of Numbers . The dialog procedures recognize 

and use three kinds of numbers: real (floating point), counters, 

and integers. Each is stored in the computer in different form/ 

and each has its specific uses. These are discussed in the following 
paragraphs, and Figure 1 (Appendix I) charts dialog commands appropriate 
to each kind of number. 

a. REAL numbers are approximate representations 

of the range 5.398 x 10 -79 to 7.237 x 10 75 (in the SIGMA 7). Typical 
real numbers are 3.2, 100.75, 3E + 10, -.0024, etc. These are 
the numbers commonly used for computation. They are also called 
'floating point' numbers (referring to the form in which they are 
stored and manipulated in the computer) . A real number stored in 
one machine word is a 'floating short' number- 

Those procedures use these single precision real numbers. In the 
SIGMA 7 this affords a precision of 6+ significant digits. 

In most DIALOG commands for real numbers, either the constant (given 
as, for example, FS'2.3'), or the variable form can be used. 

b. COUNTERS are variables with integer values in the 
range 0 to 255. They are used to control the program flow or to 
keep count of student scores, the number of trials, etc. They 
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differ from integers in the way they are stored in the computer, 

(they are packed four to a word in the SIGMA 7), so they cannot 
be used interchangeably with integer 9. Two commands exist to 
convert from counter to integer, and vice versa: CTONUM and NUMTOCT. 

Other commands are listed in Figure 1, Appendix I. 

c. INTEGERS are precise representations of the range 
31 31 

of integers from -2 to +2 -1. They can be used for indexing 

arrays, either those used in graphic commands, or those used in 
calls to FORTRAN routines. Integers are stored one to a word, 
and cannot be used interchangeably with counters without conversion 
(cp. CTONUM and NUMTOCT). 

The commands DEFNUM and STORENUH can to define intogor variable-! 

and place values in them, BUMPNUM can be used to increment (or 
an integef variable, end TOINDEX can be used to tost on an integer v&lui 
Various other DIALOG commands are usable with integers; they are listed 
in Fig. 1, Appendix I. 

B. Array Storage and Indices 

Since the graphic routines depend on arrays, we think it desirable 
to summarize the process of setting up and working with arrays, 
and indexing them. 

The first element in an array always has the index 1. If the index 
is a variable, it must be defined before it is used in a command. 

All arrays should also be defined before using. 

Arrays can be defined with DEFARRAY (see below) , and values can 
be stored ir> the array either by STORARRAY or by using the command 
FORTRAN wj.th the array name(s) as argument (s) to access a Fortran 
subroutine written to compute values for the array (s). The latter 
is more generally useful. 

An index (integer variable) can be defined by DEFNUM, and a value 
stored in it by DEFNUM or STORENUM. It can be incremented 
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(decremented) by BUMPNUM, and a test for branching can be made 
on it by TOINDEX. Those commands which are not (at present) listed 
in the SYSTEM USERS MANUAL* are given here. A sample program using 
iscs/rtc* ol Lfi*.* urtu/rj und indexing JliucLurcu uro given in Figure 
2, Appendix I. 

DEFARRAY 

reserves space for one or more arrays. 

DEFARRAY (VECTOR ,100) 

will set up 100 spaces for array VECTOR. It can have multiple argu- 
ments: 

DEFARRAY (A, 10) , (B,20) , (C,60) 

will reserve the indicated space for each of A, B and C. The array 
size must be an integer constant. The command can be used anywhere 
in the program, (after the initial statements) . 

STORARRAY 

inserts values into an array defined elsewhere. If Z contains FS 1 ! 1 
and Q contains FS 1 . 07 • 

STORARRAY VECTOR, (FS , 1.02 f ,Z,Q,FS *2) 

will place the listed values into VECTOR (1) , (2) , (3) , (4) . For 

graphic use the values should be floating short; for general use they 
can also be integer * 

The vector name may -be indexed: 

STORARRAY (A, 5) , (R,S,T,FS •2.1* ) 

will store the floating short -numbers in the list into A, beginning 
with the fifth element of A. 



♦See Appendix II 
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m for branching can be made 


STORARRAY (B,N) , {FS ' 3. 2 ' ,FS ' o . 4 ' ) 


Hich are not (at present) listed 
In here. A sample program using 


will store 3.2 and 6.4 into B(50) and B(51) if N contains the integer 


He tuxes arc given in Figure 


50. 


Vs. 


The STORARRAY command must be placed where it will be executed during 
the program run, whereas the defining commands (DEFARRAY , etc . ) need 
not be executed. 

The following commands are useful for indexing with CURVE and STORARRA 


KTOR • It can have multiple argu- 


DEFNUM 

defines (and, optionally, stores) an integer number. 


| , (C, 60) 


DEFNUM INDEX, 3 


Er each of A, B and C. The array 
Khe command can be used anywhere 


will define the label INDEX, and place an integer 3 in it. 


Statements) . 


DEFNUM INDEX, N 


b elsewhere. If Z contains FS C 1* 


is equivalent if N contains the integer 3. 


t . 02 ' ,Z ,Q,FS * 2 ) 


STORENUM 

can store an integer or integer variable in a previously defined 
location: 


lECTOR (1), (2) f (3) , (4). For 


STORENUM INX , 5 


Boating short; for general use they 


BUMPNUM 

increments an integer variable by an integer constant: 


|T r FS 1 2 . 1* ) 


BUMPNUM INDEX, -3 

will add -3 to the integer in INDEX. The second argument may not be 


rs in the list into A, beginning 


a variable name. 
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TQINDEX 

is a conditional transfer, testing on an integer variable. 
to iuuex ai, (rrarr,L&, io) 

TO INDEX Al, (ITEST,LE,K) 

will each transfer to Al if the integer in ITEST is LE 10 (or the 
integer in K) . Any of the usual relations: I/T, EQ,GT etc. can be 

used. If omitted, 

T0INDEX Al, (ITEST, 5) 

the relation GE is assumed. 
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ing on an integer variable. 

T,LE, iO) 

{ 

T,LE,K) 

integer in ITEST is LE 10 (or the 
il relations: LT, EQ,GT etc. can be 



,5) 



FIGURE 1, APPENDIX I 
COMMANDS THAT CAN BE USED WITH 

Floating Pt. Numbers Counters Integers 



AROUND, BETWEEN 
DEFNUM 

STORENUM 

DEFARRAY 

STORARRAY 

DEFTABLE 

STACK 

OUTABLE 

OUTNUM 

WRITNUM • 

SCAN 

SCAN# 

NUMBER 
PLOT, GRAPH 
RANDOM 



TO , TOCTR 


DEFNUM 


ADDCOUNT 


STORENUM 


CTARITH 


DEFARRAY 


CTOUT 


STORARRAY 


CTWRITE 


BUMPNUM 


SWITCH 


STACK 


BUMP (AUGMENT , etc • ) 


SCAN 


COUNTER 


TOINDEX 


RESET 


CTONUM 


CTONUM . 


NUMTOCT 


NUMTOCT 
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SYSTEM 



DIALOG 



START 




PF.F 


values 


DEVICE 


TL'K, ARDS 


DEFNUM 


ITEST, N 


DEF ARRAY 


(X,100) , (Y,100) 


DEFNUM 


INDEX, 1 


STORENUM 


N, 100 


STORENUM 


ITEST ,99 


FORTRAN 


VALUES, (X,Y, (N,l) ) ' 


AXES 


(MAX, (X,Y,100) ) 


CURVE 


( (X, INDEX) , (Y, INDEX) ,2) 


BUMPNUM 


INDEX, 2 


TO INDEX 


LOOP, ( INDEX, LT, ITEST) 


• 


(Program continues) 



DIALOG LOOP USING INDEXING 

This program will plot the line segments connecting every other 
pair of X,Y coordinates. 

FIGURE 2, APPENDIX I 
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